.TH E1432_SET_AUTO_GROUP_MEAS 3 E1432
.SH NAME
.nf
e1432_set_auto_group_meas \- Select auto group set up
e1432_get_auto_group_meas \- Get state of auto group set up
.fi
.IX e1432_set_auto_group_meas(3) 3
.IX e1432_get_auto_group_meas(3) 3
.SH SYNOPSIS
.cS
SHORTSIZ16 e1432_set_auto_group_meas(E1432ID hw, SHORTSIZ16 ID,
                                     SHORTSIZ16 state)
SHORTSIZ16 e1432_get_auto_group_meas(E1432ID hw, SHORTSIZ16 ID,
                                     SHORTSIZ16 *state)
.cE
.SH DESCRIPTION
\fIe1432_set_auto_group_meas\fR is used to control the automatic
multi-module setup performed in \fIe1432_init_measure\fR.  Since the
default is to perform the automatic set up, you probably will never
need to call this function.  If this function is used to turn off the
automatic group setup, each module in a group will need to be set up
by your program. For more information about multiple module groups,
see the Multiple Module Groups section.

\fIhw\fR must be the result of a successful call to
\fIe1432_assign_channel_numbers\fR, and specifies the group of
hardware to talk to.

\fIID\fR is either the ID of a group of channels that was obtained with a
call to \fIe1432_create_channel_group\fR, or the ID of a single channel.

\fIstate\fR is either \fBE1432_AUTO_GROUP_MEAS_ON\fR or
\fBE1432_AUTO_GROUP_MEAS_OFF\fR.

When \fIstate\fR is \fBE1432_AUTO_GROUP_MEAS_ON\fR,
\fIe1432_init_measure\fR automatically takes care of setting up the
multi_sync, clock_master, and clock_source parameters for the modules
in a measurement, and setting the clock frequency for the non-master
modules to match the master module.  If there is only one E1432
module, the parameters are set to avoid using the VXI TTLTRG lines,
like this:

.cS
   e1432_set_multi_sync(hw, id, E1432_MULTI_SYNC_OFF);
   e1432_set_clock_master(hw, id, E1432_MASTER_CLOCK_OFF);
   e1432_set_clock_source(hw, id, E1432_CLOCK_SOURCE_INTERNAL);
.cE

If there are multiple modules, \fIe1432_init_measure\fR picks one module to
be the clock master, and the parameters are set like this:

.cS
   e1432_set_multi_sync(hw, id, E1432_MULTI_SYNC_ON);
   for all non-master modules:
       e1432_set_clock_master(hw, slave_id, E1432_MASTER_CLOCK_OFF);
       e1432_set_clock_source(hw, slave_id, E1432_CLOCK_SOURCE_VXI);
       e1432_set_clock_freq(hw, slave_id, clock_freq_of_master_module);
   for the master module:
       e1432_set_clock_master(hw, master_id, E1432_MASTER_CLOCK_ON);
       e1432_set_clock_source(hw, master_id, E1432_CLOCK_SOURCE_INTERNAL);
.cE

When \fIstate\fR is \fBE1432_AUTO_GROUP_MEAS_OFF\fR,
\fIe1432_init_measure\fR does not do any of the above setups, and the
application is responsible for setting up the multi_sync,
clock_master, clock_source, and clock_freq parameters.

If the clock and sync/arm/trigger lines are connected to the VXI
backplane, they use two of the VXI TTLTRG lines.  The choice of which
TTLTRG lines are used is determined by the
\fIe1432_set_ttltrg_clock\fR and \fIe1432_set_ttltrg_satrg\fR
functions.

.SH "RESET VALUE"
Each group defaults to E1432_AUTO_GROUP_MEAS_ON
.SH "RETURN VALUE"
Return 0 if successful, a (negative) error number otherwise.
.SH "SEE ALSO"
.na
e1432_init_measure, e1432_create_channel_group,
e1432_set_clock_source, e1432_set_clock_freq, e1432_set_clock_master,
e1432_set_multi_sync, e1432_set_ttltrg_clock, e1432_set_ttltrg_satrg
.ad
